home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / sound / players / soundmachine.lha / SOUNDMACHINE / SoundMachine.DOC < prev    next >
Text File  |  1993-11-03  |  9KB  |  196 lines
  1. #########################################################################
  2. #                                                                       #
  3. #                          The Sound Machine                            #
  4. #                                                                       #
  5. #                            Version: 1.0                               #
  6. #                                                                       #
  7. #  Written by Syd L. Bolton  ©1993 Legendary Design Technologies Inc.   #
  8. #      25 Frontenac Avenue, Brantford, Ontario N3R 3B7 Canada           #
  9. #                           (519)-753-6120                              #
  10. #                                                                       #
  11. #      Freely Distributable - This Program Remains Copyrighted          #
  12. #                                                                       #
  13. #########################################################################
  14.  
  15.  
  16. WHAT IS THE SOUND MACHINE?
  17. ==========================
  18.  
  19.     The Sound Machine is a set of two programs for your Amiga that will
  20. enable you to load and play sound samples that are commonly found on
  21. IBM-type systems.  It will also enable you to save files in these formats.
  22. This makes it very useful for people who frequent computer bulletin-board
  23. services, as it opens up an entire library of sound files.
  24.  
  25.     There is a simpler version of The Sound Machine called 'SMPLAY'
  26. that should have included in this archive.  It is a CLI-only version of the
  27. program that only plays sound files.  It is useful for your C directory as
  28. it takes up less memory and is good for those who like the keyboard more
  29. than the mouse.
  30.  
  31. The Sound Machine presently reads and writes the following formats:
  32.  
  33.     IFF - the format used on the Amiga, in 8SVX form.
  34.  
  35.     RAW - RAW audio data, which most sound programs will load.
  36.  
  37.     WAV - The "Wave" format, most commonly used in MicroSoft Windows.
  38.  
  39.     VOC - The "Voice" format, from Creative Labs (they make the
  40.                         SoundBlaster for the IBM).
  41.  
  42.  
  43. WHAT ISN'T THE SOUND MACHINE?
  44. =============================
  45.  
  46.     The Sound Machine is NOT A SOUND EDITOR!  Although you can change
  47. the playback rate and "flip" signed samples, it does not actually do any
  48. editing on the sound files.
  49.     The Sound Machine isn't the perfect sound converter, either.  At
  50. present, it does not support 16 bit samples (from any format) nor will it
  51. save stereo WAV or VOC files.
  52.     For what most people will want, however, it does everything.  If
  53. you would like to see more sound formats supported, please write and we'll
  54. see what we can do.
  55.  
  56. PROGRAM REQUIREMENTS
  57. ====================
  58.  
  59.     The Sound Machine will run on any Amiga with 512k and OS 1.2 or
  60. higher.  It has been tested with an Amiga 3000 running AmigaDOS 2.1, and
  61. an Amiga 1000 running 1.3.
  62.     Under 2.x or 3.x, the program will use the ASL File Requester.
  63. Under 1.2 or 1.3, you will need to install the "REQ.LIBRARY" (provided)
  64. into your LIBS directory.  Do this with:
  65.  
  66.     copy req.library libs:
  67.  
  68.     Please note that 'SMPLAY', the companion player-only program does
  69. not require either of these libraries.
  70.  
  71. A TOUR OF THE GADGETS
  72. =====================
  73.  
  74.     When you first run the program you will see several gadgets along
  75. the bottom of the program window (The Sound Machine opens a Window on
  76. your Workbench Screen.  If your screen is interlaced, you may move the
  77. window around).  Most of these gadgets are self-explanitory:
  78.  
  79. OPEN    - Presents the file requester and lets you choose a sample.  Note
  80.       that the program automagically detects the file-format type.
  81.       If it can't identify the file, it reads it as "RAW" and sets the
  82.       playback rate to 10000.
  83.  
  84. SAVE AS - This will save the current sample (if there is one) in the
  85.       format that is highlighted.  When you load a sample, the screen
  86.       will change the show you the type of file that was loaded. You
  87.       are free at anytime to change the file type, and when you save
  88.       the file that is the format you will get.  Note that the program
  89.       will also automagically try to use an appropriate filename (ie:
  90.       if you loaded a file called "sound.iff", and then changed the
  91.       type to "WAV", and select SAVE AS, it will change the filename
  92.       to "sound.wav", though you are always free to call the file what
  93.       you want.
  94.  
  95. RAW, IFF, WAV, VOC: These gadgets reflect the format.  They will change when
  96.             a file is first loaded, and you can then change to the
  97.             format you wish to save in.
  98.  
  99. COMPRESS: This is a toggle gadget that is applicable TO THE IFF FORMAT ONLY.
  100.       Choosing compression with WAV format for example has NO EFFECT.
  101.       Choosing COMPRESSion with the IFF format is a good way to save
  102.       disk space as IFF files will be roughly 1/2 the size of an
  103.       equivalent WAV, VOC, or RAW file.  Not only that, but contrary to
  104.       popular belief, using COMPRESSion will not affect the quality of
  105.       the sound sample since the file is expanded to its original form.
  106.       It is NOT THE SAME as reducing the number of bits of definition
  107.       or anything of the sort.
  108.  
  109. FLIP: You will commonly need to use this gadget if you load RAW files that
  110.       come from another computer system, such as the IBM or the MACINTOSH.
  111.       The way sound samples are stored on these systems is often inverse
  112.       to the way the Amiga does it.  For example, all 8-bit sounds are
  113.       represented with a number from 0-255.  On the PC, a 0 means no sound
  114.       and 255 means full sound.  On the Amiga however, 128 indicates no
  115.       sound.  Therefore, if you ever see a file that has an abnormal amount
  116.       of high peaks, try FLIPping it and playing it again.  We have found
  117.       this to be true of many MACINTOSH samples.
  118.  
  119. RATE: The number in this string gadget represents the playback rate (samples
  120.       per second).  The program will automatically put the playback rate of
  121.       the file in this gadget for you.  In the case of "RAW" files, there
  122.       is no place for storing the rate, so The Sound Machine defaults to
  123.       using 10000.  You are free to change this number to get different
  124.       results.
  125.  
  126. PLAY: This gadget, like its name implies, plays the current sample.
  127.  
  128.  
  129. MENUS
  130. =====
  131.  
  132.     The Sound Machine also has a project menu, with similar options.
  133. It allows you to OPEN or SAVE a file (with keyboard shortcuts).  You will
  134. also find the ABOUT requester in here, and a QUIT option.
  135.  
  136. ============================================================================
  137.  
  138. The rest of the program is basically self-explanitory.  You can load
  139. samples and the program will graph them and display information about the
  140. sample (name, size and format).
  141.  
  142. WHAT CAN BE ADDED?
  143. ==================
  144.  
  145.     The following options should/could be added to the program.  In
  146. order to do this, we need to hear from people that are interested in having
  147. these features or have suggestions of their own.  Our address is listed at
  148. the bottom of the file.
  149.  
  150. * Support for AUD and SND files.  Though basically RAW files, it would be
  151.   nice to have full support for these formats for completeness.
  152.  
  153. * Support for STEREO WAV and multi-dac VOC files.  It would be helpful if
  154.   we had some official documentation on WAV files (their support in this
  155.   program comes completely from file exploration)
  156.  
  157. * Support for 16-bit samples.  Both loading and saving these samples in
  158.   16-bit form (including 16-bit IFF support) but also the option of
  159.   converting the samples to 8-bit for playback on standard Amiga hardware.
  160.  
  161. * Batch conversion support
  162.  
  163. * More DSP support, perhaps some special effects ... converting stereo
  164.   samples to mono, etc.
  165.  
  166. * The ability to work with files that are bigger than RAM.
  167.  
  168. ============================================================================
  169.  
  170.     We hope you find this product useful.  As mentioned, if you would
  171. like to see improvements made please write us a letter, send us a fax,
  172. or give us a call.  We won't make improvements without user support!
  173.  
  174.     If you do find this product useful, you may find our commercial
  175. products equally as useful.  Ask your dealer for a demonstration of
  176. ADDRESS IT! or INVOICE IT!  If your dealer doesn't carry our products,
  177. encourage him/her to call us for more information on our Amiga products.
  178.  
  179.     Have a great day!
  180.  
  181.     Syd Bolton, President
  182.     Legendary Design Technologies Inc.
  183.     25 Frontenac Avenue
  184.     Brantford, Ontario  N3R 3B7
  185.     CANADA
  186.     (519) 753-6120       - voice
  187.     (519) 753-6120 ext 5 - fax
  188.  
  189. All trademarks mentioned in this file are recognized.
  190.  
  191. The REQ.LIBRARY was written by Bruce Dawson and Colin Fox.  For space
  192. considerations, only the main executable has been included.  If you need
  193. to use this library (1.x users) if you can't find the complete REQ.LIBRARY
  194. archive (including documentation) please contact Legendary and we will
  195. provide it free of charge.
  196.